Programming with QuickTime VR

| Previous | Chapter contents | Chapter top | Section top | Next |

QTVRSetEnteringNodeProc

You can use the QTVRSetEnteringNodeProc function to install or remove a node-entering procedure.

OSErr QTVRSetEnteringNodeProc (
                     QTVRInstanceqtvr,
                     QTVREnteringNodeUPPenteringNodeProc,
                     SInt32refCon,
                     UInt32 flags);
qtvr
An instance of a QuickTime VR movie.
enteringNodeProc
A universal procedure pointer for a node-entering procedure. See "MyEnteringNodeProc" for information about node-entering procedures.
refCon
A reference constant. This value is passed to the specified node-entering procedure.
flags
Unused. Set this parameter to 0.
function result
A result code.

DESCRIPTION

The QTVRSetEnteringNodeProc function installs the procedure specified by the enteringNodeProc parameter as a node-entering procedure for the QuickTime VR movie specified by the qtvr parameter. Your procedure is called whenever a node is entered (either in response to user actions or in response to QuickTime VR Manager functions that change nodes). The reference constant specified by the refCon parameter is passed unchanged to that node-entering procedure.

To remove a previously installed node-entering procedure, set enteringNodeProc to nil .

SEE ALSO

Use QTVRSetLeavingNodeProc (next) to install or remove a node-leaving procedure.


© 1997 Apple Computer, Inc.

| Previous | Chapter contents | Chapter top | Section top | Next |